Summary

Fills every documentation gap identified in the gap analysis against FastAPI's docs.

45 new pages added across 8 new sections:

• Tutorial series (12 pages) — path/query params, request body, response model, form & file uploads, error handling, dependencies, background tasks, middleware, WebSockets, metadata & docs
• Advanced User Guide (14 pages) — custom responses, cookies/headers, direct Request access, settings/env vars, OpenAPI customisation, Jinja2 templates, lifespan events, behind-proxy, sub-applications, SSE, testing overrides, async tests, bigger apps
• Security (4 pages) — OAuth2 + JWT, OAuth2 scopes, HTTP Basic Auth intro
• Database Integration (4 pages) — SQLAlchemy async, MongoDB/Motor, async patterns
• Deployment (5 pages) — Docker (multi-stage), Nginx/Traefik, AWS/GCP/Azure, Kubernetes
• Concepts (3 pages) — async/await primer, concurrency & parallelism, Python type hints
• How-To Recipes — 15 practical patterns
• FAQ & Troubleshooting — installation, runtime, validation, middleware, WebSocket issues
• Changelog page (visible in docs nav)

5 existing pages enhanced:

• getting-started.md — curl examples, full import table, project layout
• benchmarks.md — environment spec, methodology, result interpretation
• migration-from-fastapi.md — gotcha list, msgspec field equivalents, real-world case studies
• api-reference.md — full prose docs for every exported symbol with usage examples
• mkdocs.yml — navigation tabs, all new pages, extra markdown extensions

Test plan

• mkdocs build succeeds with no warnings
• All nav links resolve (no 404s)
• Code examples are syntactically correct Python
• Docs deploy via existing docs.yml workflow